home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Sapphire Collection / Software Vault (Sapphire Collection) (Digital Impact).ISO / cdr47 / trace122.zip / TRACE1E.AIC < prev   
Text File  |  1997-02-13  |  8KB  |  224 lines
  1. ;*******************************************************
  2. ;    B E G I N     C O N F I G U R A T I O N
  3. ; 
  4. ;    TRACE1E.AIC built by Arny Krueger 02/22/86
  5. ;
  6. ;*******************************************************
  7.  
  8. ;
  9. ;  Some general equates for civilized coding
  10. ;
  11.  
  12.  
  13. cr             equ     13
  14. lf             equ     10
  15.  
  16. ;********************************************************
  17. ;
  18. ; Equates used for general configuration
  19. ;
  20. ;********************************************************
  21.  
  22. ;
  23. ; Set trace_size to number of K bytes to set aside for trace table.
  24. ;
  25.  
  26. trace_size      equ     30
  27.  
  28. ;
  29. ; Set iamhere to be a flag that indicates we are already in place.
  30. ; The first byte is interpreted as a DOS function number (AH) for INT 21h
  31. ;
  32.  
  33. iamhere         equ     0E0E0h
  34.  
  35. ;
  36. ; Set peri_int to the interrupt number (usually 060H) to be used
  37. ; by Periscope to invoke our reporting routines.
  38. ;
  39.  
  40. peri_int        equ     060h
  41.  
  42. ;
  43. ; Set prt_scr non-zero to assemble code that allows control via SHIFT-PrtSc.
  44. ;
  45.  
  46. prt_scr         equ     1
  47.  
  48. ;
  49. ; Set use_prt non-zero to start up using the printer instead of the screen
  50. ;
  51.  
  52. use_prt         equ     0
  53.  
  54. ;
  55. ; Set num_feeds to number of extra Linefeeds to send to printer to jack
  56. ; up the paper enough to let you read it, after display of menus etc.
  57. ; Note! in TRACE2E.AIC
  58.  
  59. Num_feeds       equ     5       ;Number of line feeds on printer after prompt
  60.  
  61. ;********************************************************
  62. ;
  63. ; Equates used for printing and formatting
  64. ;
  65. ;********************************************************
  66.  
  67. Edit_End        equ     0f0h    ;End of input line
  68. Edit_Byte       equ     0f1h    ;Next byte is 8-bit value to be printed in hex
  69. Edit_Word       equ     0f2h    ;Next 2 bytes are 16-bit value to be printed in hex
  70. Edit_Line       equ     0f3h    ;Next 2 bytes are address of string for print_line()
  71. Edit_Call       equ     0f4h    ;Next byte is AH arg, next 2 are DX arg,
  72.                                 ;and next 2 are subroutine address to call
  73. Edit_Dec8       equ     0f5h    ;Next byte is 8-bit value to be printed as decimal
  74. Edit_Dec16      equ     0f6h    ;Next 2 bytes are 16-bit value to be printed as decimal
  75. Edit_Skip       equ     0f7h    ;Ignore this byte (don't display it)
  76.  
  77.  
  78. ;********************************************************
  79. ;
  80. ; Map of Before and After entries in the trace table
  81. ;
  82. ;********************************************************
  83.  
  84. ;
  85. ; Trace entry byte zero (the type byte) identifies entry as follows:
  86. ; 
  87. ;   Bits 7-4 = trace type
  88. ;
  89. ;               0000 = BEFORE int was executed
  90. ;               0001 = AFTER int was executed
  91. ;               0010 = FCB referenced by an INT 21h
  92. ;               0011 = ASCIIZ referenced by an INT 21h
  93. ;
  94. ;   Bit 3    = RESERVED
  95. ;
  96. ;   Bits 2-0 = ICT # (0-7) which made this trace record
  97. ;
  98. ; Record formats are as follows:
  99. ;
  100.  
  101. BEFORE          struc           ;BEFORE trace entry
  102. B_type          db      ?       ;see above
  103. B_int           db      ?       ;INT # that was trapped
  104. B_ax            dw      ?       ;Regs BEFORE executing INT
  105. B_bx            dw      ?
  106. B_cx            dw      ?
  107. B_dx            dw      ?
  108. B_es            dw      ?
  109. B_ds            dw      ?
  110. B_ss            dw      ?
  111. B_sp            dw      ?
  112. B_si            dw      ?
  113. B_di            dw      ?
  114. B_bp            dw      ?
  115. B_cs            dw      ?       ;CS of invoker of INT
  116. B_ip            dw      ?       ;IP of invoker
  117. BEFORE          ends
  118.  
  119. AFTER           struc           ;AFTER record type
  120. A_type          db      ?       ;see above
  121. A_int           db      ?       ;INT # that was executed
  122. A_ax            dw      ?       ;Regs AFTER executing INT
  123. A_bx            dw      ?
  124. A_cx            dw      ?
  125. A_dx            dw      ?
  126. A_es            dw      ?
  127. A_ds            dw      ?
  128. A_si            dw      ?
  129. A_di            dw      ?
  130. A_bp            dw      ?
  131. A_flags         dw      ?       ;Flags AFTER doing INT
  132. AFTER           ends
  133.  
  134. FCB             struc                   ;INT 21h FCB record
  135. FCB_type        db      ?               ;see above
  136. FCB_int         db      ?               ;INT # that was executed (21h)
  137. FCB_drive       db      ?               ;drive field of FCB
  138. FCB_name        db      "????????"      ;filename field of FCB
  139. FCB_ext         db      "???"           ;extension field of FCB
  140. FCB             ends
  141.  
  142. ASCIIZ          struc                   ;INT 21h ASCIIZ record
  143. AZ_type         db      ?               ;see above
  144. AZ_int          db      ?               ;INT # that was executed (21h)
  145. AZ_str          db      "?????????????????????????????????????????????????????????????????"
  146. ASCIIZ          ends
  147.  
  148.  
  149. ;********************************************************
  150. ;
  151. ; Definition of Interrupt Control Table count
  152. ;
  153. ;********************************************************
  154.  
  155. number_icts     equ     16     ;note: number of ICT's 
  156.                                ;built into executable code
  157.                                ;in trace1.asm
  158.  
  159. ;********************************************************
  160. ;
  161. ; Definition of Interrupt Control Table entries
  162. ;
  163. ;********************************************************
  164.  
  165. ICT             struc
  166. ICT_flags       db      ?       ;See below
  167. ICT_flags2      db      ?       ;See belop
  168. ICT_intnum      db      ?       ;interrupt # this table belongs to
  169. ICT_AH_lo       db      ?       ;lower AH limit to trace
  170. ICT_AH_hi       db      ?       ;upper AH limit to trace
  171. ICT_orig_hndlr  dd      ?       ;cs:ip of original handler
  172. ICT_hits        dw      ?       ;# traces made for this ICT
  173. ICT_num         db      ?       ;ICT number (0-7)
  174. ICT             ends
  175.  
  176. ;
  177. ; Equates for flags byte of ICT
  178. ;
  179.  
  180. F_ACTIVE        equ     10000000b       ;Bit 7 = this ICT is active
  181. F_RET           equ     01000000b       ;Bit 6 = This INT exits via RET
  182. F_RET2          equ     00100000b       ;Bit 5 = This INT exits via RET2
  183. F_IRET          equ     00010000b       ;Bit 4 = This INT exits via IRET
  184. F_ENABLE        equ     00001000b       ;Bit 3 = Tracing enabled for this ICT
  185. F_FCB           equ     00000100b       ;Bit 2 = enable FCB/ASCII traces for INT 21h
  186. F_ROM           equ     00000010b       ;Bit 1 = exclude ROM invocations of this INT
  187. F_BELOW         equ     00000001b       ;Bit 0 = exclude invokers below us (DOS etc)
  188.  
  189. ;
  190. ; Equates for flags2 byte of ICT
  191. ;
  192.  
  193. F_CALL          equ     10000000b       ;Bit 7 = This ICT never returns
  194.  
  195.  
  196. ;
  197. ; Define interrupts to be traced by filling in the following ICT's.
  198. ; Note that there are only 8. That's the max that can be traced.
  199. ; Note that the F_ACTIVE flag must be set in used ICT's, and off in
  200. ; those that aren't defining something that you want traced.
  201. ;
  202. ; Don't mess with the last 3 fields in the ICT!!! Leave 'em as-is.
  203. ;
  204. ;   It is EXTREMELY important that you specify how the interrupt exits.
  205. ;   Set exactly one of the following flag bits:
  206. ;
  207. ;   F_RET   Interrupt exits via simple far RET, leaving original interrupts
  208. ;           on the stack for the caller to pop. INT's 025H and 026H are prime
  209. ;           examples.
  210. ;
  211. ;   F_RET2  Interrupt exits via RET 2, dropping original flags and returning
  212. ;           flags as set by interrupt handler. INT 021H (and anybody else
  213. ;           that uses flags like CARRY or ZERO to reflect results) does this.
  214. ;
  215. ;   F_IRET  Interrupt exits via IRET, restoring original flags from stack.
  216. ;           Hardware interrupt handlers do this, and many ROM BIOS routines.
  217. ;
  218. ;   Note that some interrupts may exit differently, depending on the specific
  219. ;   function requested. You may want to define several ICT's for a given
  220. ;   interrupt, each handling a different AH range.
  221. ;
  222. ;
  223.  
  224.